Cycle Setup - TomEE

  1. Create a directory on the TomEE server to store various configuration files for OIPA (i.e., /tomee/shared or C:\tomee\shared).

  2. Create subdirectories inside the directory from Step 1 called conf and lib.

  3. Copy CycleWeb-TomEE.war file from the OIPA distribution zip file into the webapps subdirectory of TomEE server (Example: /tomee/webapps or D:\tomee\webapps).

  4. Rename the war to CycleService.war.

  5. The coherence version that runs on TomEE-10.x is Coherence CE 22.06.12. Make sure you copy the latest following configuration files from Cycle distribution zip/conf directory into the \shared\conf directory under TomEE server (This step is extremely important):

    • cycle-coherence-cache-config.xml

    • cycle-coherence-config.xml

    • Cycle.properties

    • logging.properties

    • dataIntake-spring-beans-true.xml

    • dataIntake-spring-beans-false.xml

    • cycle-spring-beans.xml

  6. Copy the following files from the Cycle distribution zip/libs directory into the shared\lib directory:

    • commons-collections4-4.5.0.jar

    • spring-instrument-6.2.17.jar

    • jakarta.persistence-api-3.2.0.jar

    • Download aspectj 1.9.1 jars from https://www.eclipse.org/downloads/download.php?file=/tools/aspectj/aspectj-1.9.1.jar

      • Open aspectj-1.9.1.jar with an unzipping software and retrieve aspectjrt.jar and aspectjweaver.jar from the lib folder.

      • Copy aspectjrt.jar and aspectjweaver.jar into lib sub-directory.

    • Copy the database drivers for your database into lib directory of TomEE (%TomEE_Home%/lib folder).

      • Oracle – The necessary driver, ojdbc17-23.6.0.24.10.jar, is included in the lib directory of the OIPA Media Pack.

        Note: 12.2.0.0 is also supported on Oracle 19c, which is LTS (Long Term Support) and Oracle 26ai . If Oracle 19c/Oracle 26ai is used, the corresponding supported ojdbc driver version shipped with Oracle database should be used in the step above.

      • Microsoft SQL Server- Use the compatible jdbc driver shipped with MS SQL Server software. These files are not available for download. Contact your IT department if you need assistance locating these files.

      • IBM DB2 – Use the compatible jdbc driver shipped with DB2 software. These files are not available for download. Contact your IT department if you need assistance locating these files.

  7. Use a text editor to open the Cycle.properties file that you just copied to the server. The Cycle.properties file contains properties for Oracle, SQL Server and DB2 database types, with the Oracle settings active by default. The inactive settings are commented out with a '#' character at the start of each line. To change a setting, remove the '#' from the required property setting, and insert it at the beginning of the setting you want to de-activate.

  8. The properties setting must match the type of database being used.

    Note: Refer to the latest System Properties document in the Oracle Insurance Policy Administration Documentation Library published on the OHC for a complete list of all properties and allowed values.

    • application.databaseType

    • jpa.databasePlatform

  9. Identify the default locale in the Cycle.properties file. The locale selected will determine the translation that is loaded in the database for Cycle when it launches.

    • application.defaultLocale

  10. Use a text editor to open the logging.properties file that you just copied to the server. Edit the path mention for property "java.util.logging.FileHandler.pattern" with new application log location i.e. if application log location is /home/OIPA/logs then set this value as java.util.logging.FileHandler.pattern = %h/Cycle/logs/cycle%u.log. Also same time make sure that directory is created and has r/w permission.